Skip to content

docs: map Maestro compatibility debt#621

Merged
thymikee merged 1 commit into
mainfrom
docs/maestro-compat-debt-map
May 30, 2026
Merged

docs: map Maestro compatibility debt#621
thymikee merged 1 commit into
mainfrom
docs/maestro-compat-debt-map

Conversation

@thymikee

Copy link
Copy Markdown
Member

Summary

Create a reviewer-focused Maestro compatibility debt map covering parser/mapping, runtime target matching, input/focus, assertions/waits, scroll/swipe/geometry, flow control/runFlow/retry/hooks, runScript, suite discovery, and docs/support matrix.

The table records owning files, approximate code size, custom handling, native overlap, convergence opportunities, risk, test guard status, recommendations, and suggested follow-up PR lanes.

Touched-file count: 1.

Validation

Docs-only change. Verified the committed diff with git diff --check HEAD~1..HEAD.

@thymikee thymikee merged commit 14bbcf4 into main May 30, 2026
13 checks passed
@thymikee thymikee deleted the docs/maestro-compat-debt-map branch May 30, 2026 11:33
@github-actions

Copy link
Copy Markdown
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-05-30 11:34 UTC

Copy link
Copy Markdown
Member Author

Reviewed as part of the #620#626 sweep (already merged, so just a note for follow-up).

The debt map is a good anchor for the convergence work in this batch. Two additions worth folding in as the sibling PRs land, since they introduce intentional divergences that should be tracked rather than discovered later:

  • Input convergence (refactor: converge Maestro input handling #623): the tapOn + inputText → native wait+fill coalescing relies on the isLikelyTextEntrySelector keyword heuristic and assumes the tap target is the editable field. Capture that assumption + its known mismatch cases (e.g. a "Search" affordance that focuses a separate field), and the eraseTexttype('\b'…) / pasteTexttype keystroke substitutions (clipboard/delete semantics not preserved).
  • Gesture convergence (refactor: converge Maestro gesture handling #624): finger-swipe geometry now flows through the shared scroll planner; note that target-relative swipe.label/from distance stays Maestro-local by design.

No change needed to the merged doc itself — just flagging the rows to extend.


Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant